home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldlread.z / ldlread
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1. LDLREAD(3X)                                            Last changed: 1-8-99
  2.  
  3.  
  4. NNAAMMEE
  5.      llddllrreeaadd, llddlliinniitt, llddlliitteemm - Manipulates line number entries of a
  6.      common object file function
  7.  
  8. SSYYNNOOPPSSIISS
  9.      ##iinncclluuddee <<ssttddiioo..hh>>
  10.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  11.      ##iinncclluuddee <<ssyymmss..hh>>
  12.      ##iinncclluuddee <<llddffccnn..hh>>
  13.  
  14.      iinntt llddllrreeaadd (("_l_d_p_t_r,_f_c_n_i_n_d_x,_l_i_n_e_n_u_m,_l_i_n_e_n_t")
  15.      LLDDFFIILLEE **_l_d_p_t_r;;
  16.      lloonngg _f_c_n_i_n_d_x;;
  17.      uunnssiiggnneedd sshhoorrtt"lliinneennuumm"";
  18.      LLIINNEERR **_l_i_n_e_n_t;;
  19.  
  20.      iinntt llddlliinniitt (("_l_d_p_t_r,ffccnniinnddxx"")
  21.      LLDDFFIILLEE **_l_d_p_t_r;;
  22.      lloonngg _f_c_n_i_n_d_x;;
  23.  
  24.      iinntt llddlliitteemm (("_l_d_p_t_r,_l_i_n_e_n_u_m,_l_i_n_e_n_t""))
  25.      LLDDFFIILLEE **_l_d_p_t_r;;
  26.      uunnssiiggnneedd sshhoorrtt"lliinneennuumm"";
  27.      LLIINNEERR **_l_i_n_e_n_t;;
  28.  
  29. IIMMPPLLEEMMEENNTTAATTIIOONN
  30.      IRIX systems (o32 ABI only)
  31.  
  32. DDEESSCCRRIIPPTTIIOONN
  33.      llddllrreeaadd searches the line number entries of the common object file
  34.      currently associated with _l_d_p_t_r.  llddllrreeaadd begins its search with the
  35.      line number entry for the beginning of a function and confines its
  36.      search to the line numbers associated with a single function.  The
  37.      function is identified by _f_c_n_i_n_d_x, which is the index of its local
  38.      symbols entry in the object file symbol table.  llddllrreeaadd reads the
  39.      entry with the smallest line number equal to or greater than _l_i_n_e_n_u_m
  40.      into _l_i_n_e_n_t.
  41.  
  42.      llddlliinniitt and llddlliitteemm together do exactly the same function as llddllrreeaadd.
  43.      After an initial call to llddllrreeaadd or llddlliinniitt, llddlliitteemm can be used to
  44.      retrieve a series of line number entries associated with a single
  45.      function.  llddlliinniitt simply finds the line number entries for the
  46.      function identified by _f_c_n_i_n_d_x.  llddlliitteemm finds and reads the entry
  47.      with the smallest line number equal to or greater than _l_i_n_e_n_u_m into
  48.      _l_i_n_e_n_t.
  49.  
  50.      llddllrreeaadd, llddlliinniitt, and llddlliitteemm each return either SSUUCCCCEESSSS or FFAAIILLUURREE.
  51.      If no line number entries exist in the object file, if _f_c_n_i_n_d_x does
  52.      not index a function entry in the symbol table, or if it finds no line
  53.      number equal to or greater than _l_i_n_e_n_u_m, llddllrreeaadd fails.  If no line
  54.      number entries exist in the object file or if _f_c_n_i_n_d_x does not index a
  55.      function entry in the symbol table, llddlliinniitt fails.  If it finds no
  56.      line number equal to or greater than _l_i_n_e_n_u_m, llddlliitteemm fails.
  57.  
  58.      The programs must be loaded with the object file access routine
  59.      library lliibbmmlldd..aa.
  60.  
  61. SSEEEE AALLSSOO
  62.      llddcclloossee(3X), llddooppeenn(3X), llddttbbiinnddeexx(3X)
  63.  
  64.      iinnttrroo(4), llddffccnn(4), ppaatthhss..hh(4)
  65.  
  66.      This man page is available only online.
  67.